Open-Access-Monitoring Dashboards mit Quarto

Agenda

Was ist Quarto?
Aufbau Quarto Dashboards
Hands-on

Überblick Quarto

Was ist Quarto?

An open-source scientific and technical publishing system

Was kann Quarto?

Erstellen verschiedener Dokumenttypen
Erstellen dynamischer Inhalte mit Python, R, Julia oder Observable
Exportieren von Inhalten in verschiedenen Exportformaten
Veröffentlichung von Inhalten via Posit Connect, Confluence, etc.

Vorteile von Quarto

Unterstützt mehrere (Programmier-)Sprachen
Gleiche Befehle für Kernfunktionalitäten
Betriebsystemunabhängig
Ermöglicht „Single-Source-Publishing“ –> Erstellen verschiedener Dokumentformate aus einer einzigen Quelldatei

Wie sieht ein Quarto Dokument aus?

---
title: "Quarto Beispiel"
format:
    pdf: default
    html: 
      self-contained: true
---

## Hallo Quarto

Quarto ermöglicht Inhalte und ausführbaren Code in einem 
Dokument zu kombinieren. Mehr Informationen zu Quarto 
unter <https://quarto.org>.

```{r}
#| label: data-frame
#| echo: false
#| message: false
#| warning: false


AWI <- c(1435,0,0,17,0,9)
DESY <- c(0,2526,0,7,26,47)
DKFZ <- c(0,0,3549,0,13,10)
DLR <- c(17,7,0,2031,0,31)
row_names <- c("AWI","DESY","DKFZ","DLR","DZNE","FZJ")

data.set <- data.frame(AWI, DESY, DKFZ, DLR, row.names = row_names)

data.set
```

Am Anfang eines Quarto Dokuments steht in der Regel ein YAML header, In diesem werden globale Einstellungen für das Dokument vorgenommen und Dokumentmetadaten erfasst. Die Syntax hat die Form von key value pairs. Text wird in den meisten Fällen in Anführungszeichen erfasst.
Das Beispiel zeigt einen sehr dezimierten header, hier wurden lediglich der Titel und die Ausgabeformate angegeben. Im Beispiel wird sowohl eine HTML als auch eine PDF Datei aus ein und demselben Quarto Dokument erstellt.
Im body des Dokuments wird Markdown-Syntax verwendet, um das Dokument zu strukurieren. Hier wurde eine Überschrift mittels Markdown eingefügt. Überschriften werden durch Hashtags eingeleitet. Auch Freitext kann problemlos in das Dokument geschrieben werden.
Das Beispiel zeigt auch, wie code integriert werden kann. sog code chunks werden durch drei einfache anführungszeichen begrenzt. In geschweiften klammern wird die code sprache angegeben, hier R, damit der richtige interpreter für die ausführung des code genutzt wird.
den code chunks können ebnefalls optionen übergeben werden, eingeleitet durch hashtag und senkrechten strich. hier wurde ein label vergeben, das ist hilfreich für cross-referencing und es werden meldungen unterdrückt.
der code erstellt einen dataframe und ruft diesen am ende auf.

gerendert sieht das beispiel dann wie folgt aus

dies ist die HTML version, wir sehen aber auch rechts oben in der ecke, dass ebenfalls eine PDF version erzeugt wurde. so wie es am anfang im YAML header definiert wurde.

das erstmal grob dazu, wie ein Quarto Dokument in etwa aussehen kann.

Was kann mit Quarto erstellt werden?

Websites/Blogs

Dashboards

Artikel

Präsentationen

Bücher

Reports

Quarto Dashboards

Gemeinsame Darstellung von Visualisierungen, Tabellen und Text
Können folgenden Komponenten enthalten:
- Navigation Bar
- Cards, Sidebars, Toolbars
- Pages, Rows, Columns, Tabsets

Quarto Dashboards eignen sich zur gemeinsamen Darstellung von Visualisierungen, Tabellen und Text

Quarto Dashboards setzen sich aus folgenden Komponenten zusammen (wobei nicht alle zwingen vorhanden sein müssen)

Navigationsleiste: Darin können enthalten sein Icon/Logo, Titel, Autor:innenangaben und Links zu Unterseiten (falls hinzugefügt).

Cards etc: Cards sind Container für Diagramme, Datenanzeigen oder Text. Seitenleisten und Symbolleisten können z.B. zur Darstellung von Eingaben in interaktiven Dashboards verwendet, aber auch statische Inhalte darstellen.

Pages etc: Seiten, Zeilen und Spalten werden durch Markdown-Überschriften definiert (mit optionalen Attributen zur Steuerung von Höhe, Breite usw.). Tabsets können verwendet werden, um den Inhalt innerhalb einer Zeile oder Spalte weiter zu unterteilen.

Quarto Dashboards

Inhalte werden in Cards organisiert
Inhalte können statisch oder interaktiv sein
Inhalte können als Text eingegeben oder mittels Code erzeugt werden

Quarto Dashboards

Dashboards Cards sind in Reihen (rows) und ggf. Spalten (columns) angeordnet

column

row

Quarto Dashboards

Seiten, Tabsets und Seitenleisten ermöglichen umfangreichere Layouts

Open-Access-Monitoring Dashboard

Hands-on

Bitte in einem Tab folgendes Etherpad öffnen https://tinyurl.com/mpkzjbbn
Bitte in einem anderen Tab zu https://posit.cloud gehen und einloggen

Vielen Dank für Ihre Aufmerksamkeit!

info.oa-datenpraxis@listserv.dfn.de